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CHAPTER  1 
Introduction 


The  Z80  Cross  Assembler  was  written  for  a  number  of  reasons.  Among  them 
are:  (1)  the  need  of  an  assembler  customized  for  the  Project  ARIES 
applications,  (2)  the  inefficiency  of  the  MAC80  cross  assembler,  and  (3)  the 
lack  of  linking  loader  facilities  for  Z80  cross  software.  This  assembler 
provides  the  basis  for  a  linking  loader  environment  by  establishing  a 
relocatable  object  format. 

This  assembler  is  designed  to  fully  support  the  Zilog-standard  mnemonics 
for  the  Z80  op  codes.  All  Zilog-standard  mnemonics  are  implemented  by  the 
assembler.  The  pseudo-ops,  however,  are  mainly  unique  to  this  assembler. 

The  Z80  Cross  Assembler,  hereafter  referred  to  as  ASMZ80,  produces  three 
files  as  output.  The  first  file  is  the  output  file  to  the  user’s  terminal  or 
batch  job  stream.  Messages  are  sent  to  this  file  by  the  assembler.  The  second 
file  is  the  assembler  listing  file.  It  is  in  a  paged  format  suitable  for  line 
printer  listing.  Finally,  the  third  file  is  the  object  file.  It  is  in  the 
Project  ARIES  object  format. 
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CHAPTER  2 

Use  of  the  Assembler 


The  assembler  is  very  easy  to  use  if  one  is  familiar  with  timesharing  on 
the  CDC  6500/6600  under  INTERCOM.  If  not,  see  ARRADCOM  MISD  consultants  at 
Picatinny  Arsenal  on  how  to  get  started.  Basically,  one  will  need  to  put  his 
Z80  program  into  a  text  file  by  using  an  editor.  When  this  has  been  done,  the 
user  may  then  save  his  program  as  a  local  file  and  use  the  assembler.  Two  local 
files  are  generated  by  the  assembler,  a  program  listing  file  and  an  object  file. 
This  object  file  is  called  a  paper-tape  object  file  because  it  is  suitable  for 
punching  on  paper  tape.  The  paper  tape  format  also  makes  the  file  suitable  for 
transmission  over  telephone  lines  to  a  microcomputer. 


2.1  Pseudo-Ops 

The  pseudo-ops  are  one  of  the  features  that  make  one  assembler  different 
from  another.  For  this  reason,  the  pseudo-ops  of  ASMZ80  are  listed  in  some 
detail. 

DB  -  define  byte.  The  operand (s)  of  this  pseudo-op  are  evaluated 
and  emitted  one  byte  per  operand.  Strings  (enclosed  in 
single  quotes)  are  an  exception  to  this,  with  one  byte  being 
emitted  for  each  character  in  the  string  (not  counting  the 
beginning  and  ending  single  quotes). 

DEFB  —  define  byte.  This  pseudo-op  was  included  to  help 

maintain  compatability  with  the  Zilog-standard  pseudo-ops. 

The  DEFB  function  is  a  subfunction  of  DB,  and  DEFB  in  Z80ASM 
is  implemented  exactly  as  DB. 

DEFM  —  define  message.  Same  as  DEFB. 

DEFS  —  define  storage.  This  pseudo-op  was  included  to  help 

maintain  compatability  with  the  Zilog-standard  pseudo-ops. 

The  DEFS  function  is  a  subfunction  of  DS,  and  DEFS  in  Z8QASM 
is  implemented  exactly  as  DS. 

DEFW  —  define  word.  This  pseudo-op  was  Included  to  help 

maintain  compatability  with  the  Zilog-standard  pseudo-ops. 

The  DEFW  function  is  a  subfunction  of  DW,  and  DEFW  in  Z80ASM 
is  implemented  exactly  as  DW. 
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DISPLAY  -  display  the  value  of  an  expression  on  the  user's 
terminal.  This  is  useful  when  the  user  wishes  to  know  a 
particular  value  computed  by  the  assembler  without  having  to 
scan  through  the  listing.  For  example,  a  typical  use  of 
DISPLAY  would  be  to  display  the  range  of  an  assembly. 

DS  -  define  storage.  The  operand  field  is  evaluated,  and  that 
many  bytes  of  memory  are  reserved  starting  with  the  current 
value  of  the  memory  location  counter. 

DW  -  define  word.  The  operand(s)  of  this  pseudo-op  are  evaluated 
and  emitted  one  word  (two  bytes)  per  operand. 

END  -  end  of  program.  This  pseudo-op  signifies  that  there  is  no 
more  program  code  in  the  source  file. 

ECU  -  this  evaluates  the  operand  field  and  assigns  the  value  to 
the  label  given  at  the  beginning  of  the  line.  Absence  of  a 
label  will  be  noted  as  an  error.  Note  that  equates  with 
register  names  will  allow  the  user  to  employ  the  new  symbols 
as  he  would  employ  the  corresponding  register  name. 

EXT  -  defines  a  symbol  to  be  external.  This  will  enable  later 
reference  to  these  symbols  by  the  linking  loader  at  load 
time.  The  EXT  pseudo  op  must  be  present  in  both  the  source 
in  which  the  symbol  is  defined  and  the  source  in  which  the 
symbol  is  referenced.  The  label  associated  with  EXT,  then, 
is  not  processed  as  a  normal  label;  it  appears  twice  in  the 
definition  source. 

HEADER  -  place  a  header  at  the  top  of  the  following  pages.  This 
header  is  located  under  the  title  generated  by  the  TITLE 
pseudo-op.  The  string  in  the  operand  field  (enclosed  in 
single  quotes)  appears  as  the  header. 

LIST  -  turns  on  the  program  listing  (generation  of  the  listing 
file).  This  is  the  default. 

MESSAGE  -  display  a  message  on  the  user's  terminal.  This  command 
is  used  to  -send  the  string  in  the  operand  field  to  the 
user's  terminal.  It  may  be  used  in  conjunction  with  the 
DISPLAY  pseudo-op  to  print  a  message  along  with  the  value 
displayed.  The  string  in  the  operand  field  (enclosed  in 
single  quotes)  appears  as  the  message. 

NOLIST  -  turns  off  program  listing.  The  advantage  of  this 

pseudo-op  is  a  slight  increase  in  the  efficiency  of  the 
assembler  and  lower  printing  costs. 

NOSYM  -  inhibits  the  generation  of  a  symbol  table  in  the  program 
listing.  The  generation  of  a  symbol  table  is  the  default. 

ONLY8080  -  sets  a  switch  which  will  raise  an  error  if  an 
instruction  which  will  not  execute  on  the  8080  is 
encountered.  This  option  is  disengaged  as  default. 

ORG  -  sets  the  memory  location  counter  of  the  assembler  to  the 
value  of  the  expression  in  the  operand  field.  If  a  label  is 
present,  it  is  also  given  that  value.  Secondly,  this 
pseudo-op  sets  the  address  mode  to  absolute.  The  absolute 
addressing  mode  is  the  default.  If  an  ORG  is  not  specified, 
assembly  will  start  with  zero  as  the  value  of  the  memory 
location  counter. 

PAGE  -  forces  a  page  eject.  This  will  help  in  making  listings 
more  readable. 

REL  -  sets  the  address  mode  to  relative.  No  operand  is  required. 
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TITLE  -  places  a  title  across  the  top  of  each  page.  The  string 
in  the  operand  field  (enclosed  in  single  quotes)  appears  as 
the  title. 

XREF  -  produces  a  cross-referenced  symbol  table  at  the  end  of  the 
listing.  The  default  is  a  normal,  non-cross-referenced 
symbol  table. 

The  following  is  an  SDL  description  of  these  pseudo-ops. 


<ALPHA> 

<ALPHANUM> 

<COLON> 

<LABEL> 

<HEX> 

<HEXNUM> 

<STRING> 

<B> 

<B1> 

<EXPRESSION> 


•A’  !  ..  !  'Z' 

<ALPHA>  !  *0’  !  ..  f  '9' 

t  .  t 

<ALPHA>  <ALPHANUM>*  <C0L0N>? 

•A'  !  ..  !  'F'  !  'O'  !  ..  !  '9' 

<HEX>+ 

' ' '  "string  of  chapacters"  ’ ' ' 

•  •+ 

•  •* 

"a  valid  arithmetic  or  string  expression  for  this 
assembler  (see  text)" 


<DIGIT>  :  'O'  !  ..  !  '9' 

<DECNUM>  :  <DIGIT>+ 

<DB  PSEUDO-OP>  :  <LABEL>?  <B>  'DB*  <B>  <EXPRESSION>  «B1>  ','  <B1>  <EXPRESSIOM> ) « 

<DEFB  PSEUDO-OP>  :  <LABEL>?  <B>  'DEFB'  <B>  <EXPRESSION> 

<DEFM  PSEUDO-OP>  :  <LABEL>?  <B>  'DEFM*  <B>  "a  string" 

<DEFS  PSEUDO-OP>  :  <LABEL>?  <B>  'DEFS'  <B>  <EXPRESSION> 

<DEFW  PSEUDO-OP>  :  <LABEL>?  <B>  'DEFW*  <B>  <EXPRESSION> 

<DISPLAY  PSEUDO-OP>  :  <B>  'DISPLAY'  <B>  <EXPRESSION> 

<DS  PSEUDO-OP>  :  <LABEL>?  <B>  'DS*  <B>  <EXPRESSION> 

<DW  PSEUDO-OP>  :  <LABEL>?  <B>  'EW  <B>  <EXPRESSION>  «B1>  ','  <B1>  <EXPRESSION» « 

<END  PSEUDO-OP>  :  <LABEL>?  <B>  'END' 

<EQU  PSEUDO-OP>  :  <LABEL>  <B>  'EQU'  <B>  <EXPRESSION> 

<EXT  PSEUDO-OP>  :  <LABEL>  <B>  'EXT' 

< HEADER  PSEUDO-OP>  :  <LABEL>?  <B>  'HEADER'  <B>  <STRING>  '" 

<LIST  PSEUDO-OP>  :  <B>  'LIST' 

<MESSAGE  PSEUDO-OP>  :  <B>  'MESSAGE'  <B>  ”'  <STRING>  •" 

<N0LIST  PSEUD0-0P>  :  <B>  'NOLIST' 

<NOSYM  PSEUDO-OP>  :  <B>  'NOSYM' 

<0NLY8080  PSEUDO-OP>  :  <B>  'ONLY8080' 

<ORG  PSEUD0-0P>  :  <LABEL>?  <B>  'ORG'  <B>  <EXPRESSION> 

<PAGE  PSEUD0-0P>  :  <B>  'PAGE' 

<REL  PSEUDO-OP>  :  <B>  'REL' 

<TITLE  PSEUD0-0P>  :  <B>  'TITLE'  <B>  »"  <STRING>  '” 

<XREF  PSEUDO-OP>  :  <B>  'XREF' 


2.2  Addressing  Modes 

There  are  two  addressing  modes  supported  by  this  assembler  —  absolute  and 
relative.  If  an  entire  assembly  is  run  in  absolute  mode,  then  the  resulting 
object  module  will  be  completely  compatable  with  the  ARIES/MUMS  object  format. 
To  put  the  assembler  in  absolute  mode,  one  simply  uses  the  ORG  pseudo-op, 
supplying  the  starting  address  of  the  memory  location  counter  as  the  operand. 
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The  relative  addressing  mode  is  more  flexible.  Using  this  mode,  object 
libraries  can  be  built  using  relocatable  routines.  The  only  problem  encountered 
in  relocation  is  the  use  of  word-valued  (two  byte)  addresses  within  the 
assembled  program.  In  absolute  mode,  these  addresses  are  indistinguishable  from 
any  pair  of  bytes,  so  relocation  is  impossible.  In  relative  mode,  these 
addresses  are  prefixed  by  the  letter  * R •  to  signify  a  relative  address.  A 
two-byte  value  follows  the  'R';  this  is  the  offset  from  the  beginning  of  the 
current  relocatable  module.  Thus,  when  loading,  this  value  is  added  to  the 
value  of  the  memory  address  at  which  the  current  code  segment  is  to  reside. 
Relative  mode  is  entered  by  using  the  REL  pseudo-op,  which  needs  no  qperand. 
The  default  address  mode  of  ASMZ80  is  absolute. 

Note  that  one  can  switch  back  and  forth  between  absolute  and  relative 
addressing  modes,  referencing  absolute  symbols  in  relative  code  and  relative 
symbols  in  absolute  code.  It  is  the  responsibility  of  the  programmer  to  be  sure 
he  is  not  overlaying  some  of  his  own  code  at  load  time  if  he  chooses  to  change 
modes  like  this. 

External  symbols  are  provided  to  allow  the  programmer  to  use 
previously-assembled  routines  by  name,  rather  than  by  the  awkward  method  of 
using  equates  in  which  the  programmer  does  the  memory  mapping.  A  symbol  is 
declared  external  by  the  EXT  pseudo-op,  with  the  symbol  at  the  beginning  of  the 
line  being  the  label  referenced.  These  externals  can  be  either  absolute  or 
relative  and  must  be  resolved  by  the  linker  at  load  time. 


2.3  Expression  Syntax 


Expressions  analyzed  by  the  assembler  must  be  rather  simple  in  form.  Since 
parentheses  are  used  for  indirection,  no  effort  was  made  to  implement  them  in 
expressions.  Hence,  no  nesting  of  expressions  is  permitted,  and  evaluation  is 
done  strictly  from  left  to  right  with  operator  precedence.  Also,  no  blanks  are 
accepted  within  an  expression,  and  addressing  modes  cannot  be  mixed  freely. 
External  reference  symbols  can't  be  used  in  expressions,  and  relative  symbols 
can  only  be  operated  on  by  plus  (+)  and  minus  (-).  The  following  operators  are 
recognized  by  the  assembler: 


Operator 


Priority  Description 


/ 

l 


& 

f 


4  Multiplication 

4  Division 

4  Modulo 

3  Addition 

3  Subtraction 

2  Logical  AND 

1  Logical  OR 


2.4  Invoking  the  Assembler 

Using  the  assembler  is  very  simple  once  one  has  written  the  text  file.  Use 


Page  5 


Z80ASM  -  Z80  CROSS  ASSEMBLER  and  LINKER  USER'S  MANUAL 


of  the  assembler  is  done  in  two  steps:  (1)  initialization,  which  is  done  only 
once  during  a  timesharing  session,  and  (2)  invocation  of  the  assembler  itself. 

It  is  usually  a  good  idea  to  initialize  the  user's  timesharing  environment 
immediately  after  logging  in  to  the  system.  This  is  done  by  issuing  the 
following  INTERCOM  commands: 

ATTACH , PI , PROFIL , IDrXXXXXX 
!  REWIND, PI 

COPY, PI, PROFIL 

RETURN, PI 

‘  RFL, 64000 

ETL.200 

CONNECT, INPUT, OUTPUT 

Once  this  has  been  done,  the  user  is  ready  to  perform  his  normal 
timesharing  activities.  When  the  user's  program  source  file  is  ready  to  be 
assembled,  the  user  executes  ASMZ80  by  issuing  the  following  INTERCOM  command: 

BEGIN , ASSM , , SOURCE , LISTI NG , OBJECT , 0BJECT2 

SOURCE  is  the  user's  assembler  language  source  file,  LISTING  is  the 
assembler’s  output  listing  file,  OBJECT  is  the  assembler's  iNTEL-format  output 
object  file,  and  0BJECT2  is  the  assembler's  ARIES-format  output  object  file. 
All  names  are  optional,  the  files  Z80SRC ,  Z80LST,  Z800BJ1,  and  Z800BJ2  being 
used  if  the  replacement  is  not  indicated.  All  files  are  rewound  before  and 
after  using  them. 

The  assembler  will  run  in  a  field  length  of  less  than  20000B  if  the  program 
is  not  large  (less  than  500  bytes),  and  has  never  (yet)  run  out  of  space  with  a 
field  length  of  64000B. 

At  the  end  of  the  assembly,  the  assembler  will  tell  the  user  how  many 
errors  were  detected.  Errors  are  indicated  in  the  output  listing  by  a  hash 
character  ('0')  in  one  of  the  first  four  columns  of  the  error  line.  Hence,  the 
user  may  use  an  editor  to  find  the  error  lines  by  searching  for  this  character 
in  the  first  four  columns.  Also  in  the  listing  are  the  error  message  codes, 
located  between  the  object  code  and  actual  source  line  (the  actual  source  line 
is  preceeded  by  a  colon,  ':'), 

An  error-listing  procedure  is  available  to  the  user  through  the  PROFIL. 
This  is  invoked  by 

BEGIN, ERRORS, .LISTING 

where  LISTING  is  the  listing  file  generated  by  the  assembly.  This  procedure 
will  list  all  error  lines  on  the  user's  terminal  for  his  review. 
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CHAPTER  3 
Use  of  the  Linker 


One  of  the  functions  of  ASMZ80  is  to  allow  the  user  to  maintain  object  code 
libraries,  removing  the  need  to  assemble  all  the  routines  he  needs  every  time. 
To  this  goal,  he  must  declare  the  names  of  his  routines  to  be  external  when  they 
are  assembled  and  put  the  relocatable  object  into  his  library. 


3.1  Library  Files 

The  library  file  format  is  very  simple,  and  it  will  allow  the  use  of  basic 
utilities  to  construct  it.  It  is  a  segmented  file  of  text,  with  each  segment 
containing  exactly  one  object  module.  For  example,  to  add  a  newly-assembled 
object  file,  OBJ,  to  the  library  file,  LIB,  the  user  need  only  type: 

REWIND, LIB 
COPY, LIB, NEWLIB 
REWIND, OBJ 
COPY, OBJ, NEWLIB 
REWIND, NEWLIB 
REWIND, LIB 
COPY, NEWLIB, LIB 

This  will  add  the  object  file  to  the  library  file,  LIB. 


3.2  Invoking  the  Linker 

Hie  procedure  'LINK'  is  used  to  run  the  linker.  To  invoke  the  linker, 

type: 

BEGIN, LINK, .SOURCE, LIBRARY, OBJECT, 0BJECT1 .MESSAGE 

where  SOURCE  is  the  main  object  module,  LIBRARY  is  the  object  library  file, 
OBJECT  is  the  output  object  file  in  INTEL  hex  format,  0BJECT1  is  the  output 
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object  file  in  ARIES- format ,  and  MESSAGE  is  the  output  message  file  produced  by 
the  linker  which  holds  any  diagnostics  and  a  load  map.  SOURCE  and  LIBRARY  must 
be  relocatable  object  files  in  ARIES  format. 

When  the  linker  starts  running,  the  user  will  type  a  linker  directive.  The 
linker  directives  are: 

R  —  link  and  relocate.  This  tells  the  linker  to  leave  the 
resolved  object  module  in  relocatable  format. 

A  <address>  -  link  and  generate  absolute  code.  This  tells  the 
linker  to  output  the  object  in  absolute  format,  with  the  hex 
string  specifying  the  start  address.  This  command  contains 
no  blanks,  and  takes  the  form  of  'AHHHH' ,  where  'H' 
represents  any  valid  hexadecimal  digit. 

Any  errors  other  than  multiple  symbol  definition  are  considered  to  be 
catastrophic  and  will  abnormally  terminate  the  linker. 
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CHAPTER  4 
Appendices 


Appendix  A 

Summary  of  Z80  Mnemonics 


ADC 

A,Q8 

CCF 

ADC 

HL.R16A 

CP 

Q8 

ADD 

A,Q8 

CPD 

ADD 

HL.R16A 

CPDR 

ADD 

IX.R16B 

CPI 

ADD 

IY.R16C 

.OPR 

AND 

Q8 

CPL 

BIT 

N3.Q8A 

DAA 

CALL 

N16 

DEC 

Q8A 

CALL 

CF.N16 

DEC 

R16D 
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Summary  of  Z80  Mnemonics,  Con't 


DI 

JP 

(IY) 

JP 

N16 

DJNZ 

E 

JP 

CF,N16 

El 

JR 

E 

JR 

CFA,E 

EX 

SP,HL 

R8,Q8 

EX 

SP.IX 

LD 

EX 

SP,IY 

LD 

A,  (N16) 

EX 

AF,AF' 

LD 

(N16) ,A 

EXX 

LD 

R16D, (N16) 

LD 

(N16) ,R16D 

HALT 

LD 

R16D.N16 

LD 

SP,HL 

IM 

0 

LD 

SP,IX 

IM 

1 

LD 

SP,IY 

IM 

2 

LD 

A,R 

LD 

A, I 

IN 

A,(N8) 

LD 

R,A 

IN 

R8,(C) 

LD 

I, A 

LD 

A.(BC) 

INC 

Q8A 

LD 

A,(DE) 

INC 

R16D 

LD 

(BC),A 

LD 

(DE) ,A 

IND 

LDD 

INDR 

LDDR 

INI 

LDI 

INIR 

LDIR 

JP 

(HL) 

NEC 

JP 

(IX) 

NOP 
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Summary  of  Z80  Mnemonics,  Con't 


OR 

08 

RLCA 

RLD 

OTDR 

RR 

Q8A 

OTIR 

■  RRA 

OUTD 

RRC 

Q8A 

OUTI 

RRCA 

OUT 

(N8),A 

RRD 

OUT 

(C) ,RS 

RST 

N3*8 

POP 

R16E 

SBC 

A,Q8A 

SBC 

HL, R16A 

PUSH 

R16E 

SCF 

RES 

N3,Q8A 

SET 

N3.Q8A 

RET 

RET 

CF 

SLA 

Q8A 

RETI 

SRA 

08a 

RETN 

SRL 

Q8A 

RL 

Q8A 

SUB 

08 

RLA 

RLC 

Q8A 

XOR 

08 
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Definition  of  Symbols 


The  special  symbols  in  the  above  table  have  the  following  significance: 
R8  —  any  of  the  set  (A,B,C,D,E,H,L) 

Q8A  —  any  of  R8  or  [(HL),(IX+D),(IY+D)] 

08  —  any  of  Q8A  or  N8 

D  —  when  used  in  (IX+D)  or  (IY+D),  it  must  have  a 
value  between  -128  and  +127  decimal,  inclusive 

E  —  used  with  jump  relative  instructions,  it  must  have 
a  value  between  -126  and  +129  decimal,  inclusive.  It  is 
usually  an  expression  of  the  form  'SYMB0L-$'. 

R16  —  any  of  the  set  (AF,BC,DE,HL,IX,IY,SP) 


R16A 

—  any  of  the  set 

(BC.DE.HL.SP) 

R16B 

—  any  of  the  set 

(BC,DE,IX,SP) 

R16C 

—  any  of  the  set 

(BC,DE,IY,SP) 

R16D 

—  any  of  the  set 

(BC,DE,HL,IX,IY,SP) 

R16E 

—  any  of  the  set 

(AF,BC,DE,HL,IX,IY) 

N3  - 

a  3-bit  integer; 

any  of  the  set  (0 

7) 

N8  — 

an  8-bit  integer; 

any  of  the  set  (0  .. 

255) 

N16  - 

-  a  16-bit  integer 

;  any  of  the  set  (0  .. 

65535) 

CF  — 

any  of  the  set  (Z 

,NZ,C,NC,PO,PE,M,P) 

CFA  - 

-  any  of  the  set  (Z,NZ,C,NC) 
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Appendix  B 

Relocatable  Object  Format 


This  object  file  format  is  compatible  with  the  MUMS  object  format 
implemented  by  Kominczak  in  the  Universal  Cross  Assembler  and  the  ARIES  object 
format  implemented  by  Conn  in  Project  ARIES.  This  format  additionally  allows 
relocatable  references  by  specifying  an  offset  from  the  beginning  of  the  current 
assembly  and  external  references  by  specifying  a  name.  All  external  symbols  are 
listed  in  an  External  Symbol  Dictionary  (ESD)  at  the  beginning  of  the  object 
module  to  reduce  lookahead  problems.  An  object  module  can  be  described  in  SDL 
by  the  following: 


<OBJECT  M0DULE> 

• 

• 

<ESD  BLOCK>*  <DATA  BLOCK>*  ’$ 

<ESD  BLOCK > 

• 

• 

’#S*  < SYMBOL  ENTRY>+  <V8> 

<SYMBOL  ENTRY> 

• 

• 

< RELATIVE  DEFINITION>  ! 
ABSOLUTE  DEFINITION>  ! 
<REFERENCE  DEFINITION> 

< RELATIVE  DEFINITION> 

• 

• 

’R'  <NAME>  <V16> 

< ABSOLUTE  DEFINITION 

• 

• 

•A’  <NAME>  <V16> 

< REFERENCE  DEFINITION> 

• 

• 

•F*  <NAME> 

<NAME> 

• 

• 

<ALPHA>  <ALPHANUM>*  <BLANK> 

<ALPHA> 

• 

• 

•A'  !  ..  !  ’Z' 

<ALPHANUM> 

• 

• 

<ALPHA>  !  ’0*  f  ..  !  ’9’ 

<  BLANK > 

• 

• 

"space  character" 

<V8> 

• 

• 

<HEX  DIGIT>  <HEX  DIGIT> 

<V16> 

• 

• 

<V8>  <V8> 

<HEX  DIGIT> 

• 

• 

•A'  f  ..  1  *F'  !  *0’  !  ..  !  * 

<DATA  BLOCK> 

• 

• 

<V16>  <VALUE>+  <V8> 

<UALTE> 

• 

• 

<u8>  i 

<RELATIVE  REFERENCE>  ! 
<EXTERNAL  REFERENCE> 

< RELATIVE  REFERENCE> 

• 

• 

’R*  <V16> 

Z80ASM  -  Z80  CROSS  ASSEMBLER  and  LINKER  USER'S  MANUAL 
<EXTERNAL  REFERENCE>  :  »X'  <NAME> 

All  characters  except  '#',  'A',  and  the  checksum  contribute  to  the 

modulo-256  checksum  in  the  following  manner: 

<V8>  —  the  ASCII  characters  are  converted  to  a  single  byte 
value,  and  the  value  of  the  byte  is  added  to  the  checksum. 

<ALPHA>  —  the  value  is  computed  by  adding  the  ordinal  number 
('A'=1)  to  9.  For  example,  for  the  character  'Z',  35  will 

be  added  to  the  checksum. 

All  other  characters,  including  blank,  are  given  the  value  zero. 

All  <Vl6>'s  are  not  equal  under  the  eyes  of  the  linker.  When  in  absolute 
load  mode,  the  address  immediately  following  the  beginning  hash  character  ('#') 
is  given  high-order  byte  first.  All  other  word  values  are  given  low-order  byte 
first. 
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Appendix  C 

Assembler  Error  Messages 


A  —  improper  addressing  mode  usage  in  an  expression 

E  —  null  addressing  mode  encountered  in  an  expression;  this  should  never  occur 
F  —  forward  reference  detected  in  operand  of  an  EQU  or  DS 
I  —  invalid  instruction  mnemonic 

M  —  multiple  definitions  of  a  symbol  have  been  encountered 
N  —  invalid  character  encountered  in  conversion  of  a  numeric  operand 

0  —  the  all-inclusive  operand  error.  This  usually  signifies  improper  usage  of 

predefined  register  and  flag  names. 

P  —  missing  'END'  statement 

Q  —  an  equate  cannot  be  made  to  an  indirect  symbol 

R  —  the  range  of  a  jump  relative  (-126  to  +129  from  the  current  instruction) 
has  been  exceeded 

S  —  a  string  has  not  been  terminated 

U  —  an  undefined  symbol  has  been  used  in  an  operand  field 

Z  —  an  instruction  has  been  used  which  is  valid  for  the  Z80  but  not  for  the 

8080.  This  error  can  occur  only  if  the  ’0NLY8080'  pseudo-op  has  been  used. 
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CHAPTER  5 


Source  Code  Listings 

This  chapter  presents  the  source  code  listings  of  the  Z80ASM  system. 
Specifically,  the  programs  addressed  by  this  chapter  are  — 

ZLDR  The  Relocatable  Linking  Loader  for  the 

Z80  Assembler 

Z80ASM  The  Z80  Assembler 


Page  17 


Z80ASM  -  Z80  CROSS  ASSEMBLER  and  LINKER  USER'S  MANUAL 


Source  Code  Listings 


ZLDR  —  The  Relocatable  Linking  Loader 


2 LOR* ) 

ZLOR  WAS  ORIGINALLY  WRITTEN  BY  GEORGE  LEHMANN  AT  THE 
UNIVERSITY  OF  ILLINOIS  AT  URBANA-CHAMPAIGN.  IL 
ZLOR  IS  MOOIFIEO  ANO  MAINTAINED  ON  THE  ARRADCOM  CDC 
6S00/6600  BY  1 LT  RICHARO  CONN.  MISO,  SATCOMA.  FORT 
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(«  IF  parent  is  resolved,  check  left  SON  *) 
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REAOPRM( SYM* 1 1 ) 


(•  ANO  UPDATES  THE  CHECKSUM. 


(•  PROCEDURE  READOBJ  READS  ONE  CHARACTER  FROM  THE  LIBRARY  •) 
(•  FILE.  ANO  UPOATES  THE  CHECKSUM  ACCORDINGLY.  •) 


PROCEDURE  REAOOBJ  (  VAR  CH  :  CHAR); 

BEGIN 

REAO(OBJLlB.CH);  „  , 

IF  (CH  IN  *'0'..‘9‘f)  THEN  1NCKSUM  :*  I NCKSUM  ♦  ORD(CH)  -  ORD( 


PROCEDURE  LOAOOATA  COPIES  THE  OBJECT  PARTITION  INTO  THE) 
TEMPORARY  FILE.  •) 


MRI TElN(OBd ,  .HEX ( OUTCKSUM  DIV  1 6) > HEX ( OUTCKSUM) ) 

OBJCNT  :>  0; 

OUTCKSUM  :>  0; 


(•  PROCEDURE  EMIT  PUTS  A  SINGLE  BYTE  INTO  THE  OUTPUT  OBJECT  •) 


(•  PROCEDURE  PASSTwO  MILL  COPY  THE  TEMPORARY  OBJECT  FILE  TO  •) 
(•  THE  OUTPUT  OBJECT  FILE,  COMPLETING  RESOLUTION  OF  ALL  *) 


PROCEDURE  PASS TWO; 
VAR  CH  :  CHAR; 


Z80ASM  -  Z80  CROSS  ASSEMBLER  and  LINKER  USER’S  MANUAL 


Source  Code  Listings 


Z80ASM  —  The  Z80  Assembler 
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